home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / bigtxt21.zip / BIGTEXT.DOC < prev    next >
Text File  |  1995-02-04  |  20KB  |  330 lines

  1.  
  2.              ███████▄  ▄▄▄             ███████                   ▄▄▄  
  3.              ███  ███  ▀▀▀               ███                     ███  
  4.              ███▄███▀ ████  ▄████▄       ███   ▄████▄ ██▄  ▄██ ███████
  5.              ███▀▀███  ███ ███  ███      ███  ███▄▄███ ▀████▀    ███  
  6.              ███  ███  ███ ▀██▄▄███      ███  ███▀▀▀▀▀ ▄████▄    ███  
  7.              ███████▀ █████  ▀▀▀███      ███   ▀█████ ██▀  ▀██   ▀█████
  8.                              █████
  9.  
  10.  
  11.                                  William Luitje
  12.                                  4 February 1994
  13.  
  14.        ┌─────────────────────────────────────────────────────────────────┐
  15.        │▒▒▒ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  16.        └─────────────────────────────────────────────────────────────────┘
  17.  
  18.         This program will translate your text to BIG text. It can be used 
  19.         in  batch files to produce messages which can be read across  the 
  20.         room  or the output can be redirected to a file whence it can  be 
  21.         imported into a text or program file for use as a heading,  title 
  22.         or  e-mail  signature.   The output can also be redirected  to  a 
  23.         printer to produce a banner.   It is inspired by a program called 
  24.         bigecho  written  by  Barry  Simon  and  Richard  Wilson,   which 
  25.         originally appeared in 1986.   In the fading days of DOS it is my 
  26.         pleasure  to  bring  you  an  improvement  to  a  utility   which 
  27.         originally appeared in DOS' youth. 
  28.         
  29.        ┌─────────────────────────────────────────────────────────────────┐
  30.        │▒▒▒ Quick Start ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  31.        └─────────────────────────────────────────────────────────────────┘
  32.  
  33.         Run  the demo batch file to see what kinds of things are possible 
  34.         and then run the program with no arguments for a list of switches 
  35.         and usage hints.  Then, play! 
  36.  
  37.        ┌─────────────────────────────────────────────────────────────────┐
  38.        │▒▒▒ Character Styles ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  39.        └─────────────────────────────────────────────────────────────────┘
  40.  
  41.         BIGTEXT  supports 5 different character styles which specify  the 
  42.         size  and orientation of the big characters.   You specify  which 
  43.         style to use with the /Sx switch.  Replace "x" with the letter of 
  44.         the  desired style as shown below.   Each character that  BIGTEXT 
  45.         produces  is  formed by taking one or more pixels from  the  font 
  46.         table  and  replacing them with one or more  regular  characters.  
  47.         The following descriptions tell how many ordinary character  rows 
  48.         and  columns are used to form a big character in the default  CGA 
  49.         font.  The actual size will depend on the font used; for example, 
  50.         when  using the VGA 8x16  font,  a  character in the narrow style 
  51.         will  be  4  columns wide and 16  rows tall since a  regular  VGA 
  52.         character is 8 pixels wide and 16 pixels tall . 
  53.  
  54.         ■ Big - 8 x 8.  The default style. (/SB)
  55.         ■ Narrow - 8 x 4. (/SN)
  56.         ■ Short - 4 x 8. (/SS)
  57.         ■ Petite - 4 x 4. (/SP)
  58.         ■ Vertical - 8 x 8.  These are 'big' characters standing on their 
  59.           sides. (/SV)
  60.  
  61.         Short style has the best proportioned characters but narrow style 
  62.         is  useful  when you want to pack up to 19  characters on  an  80 
  63.         column  screen.    Petite big characters?   Well,  everything  is 
  64.         relative!   Petite style can only be used with an EGA or VGA card 
  65.         and can only be viewed on the screen.  If you redirect the output 
  66.         to a file or printer,  you won't get what you want.    Obviously, 
  67.         vertical style can be used to make banners. 
  68.  
  69.        ┌─────────────────────────────────────────────────────────────────┐
  70.        │▒▒▒ Character Fonts ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  71.        └─────────────────────────────────────────────────────────────────┘
  72.  
  73.         BIGTEXT supports an almost unlimited number of fonts which can be 
  74.         used  with  any of the above styles.   Specify which font to  use 
  75.         with the /Fx switch replacing "x" with the value for the font you 
  76.         want to use.   BIGTEXT does not contain any font definitions.  It 
  77.         uses definitions from 3 possible sources:  1) the system or E/VGA 
  78.         ROM  BIOS,  2)  screen fonts which have been installed  into  the 
  79.         Alternate  Character Set Override Table of the Video Save  Table, 
  80.         and 3) the currently displayed screen font. 
  81.         
  82.         The  default font is CGA (/FC)  which should be available on  all 
  83.         PCs, even those with monochrome display cards.  This font uses an 
  84.         8x8   pixel array but does not include character definitions  for 
  85.         characters above the delete character (hex 7F); these include the 
  86.         Greek letters and line drawing characters.  If you have an EGA or 
  87.         VGA  card  in  your system,  BIGTEXT can use it to make  any  IBM 
  88.         character using an 8x8  (/FE) or 8x14 (/F4) matrix.  The 8x8  EGA 
  89.         character  definitions may differ slightly from the CGA ones  and 
  90.         you may like them better.  If you have a VGA card, an 8x16  (/F6) 
  91.         font is also available.   BIGTEXT does not check to see that  you 
  92.         have  the  proper hardware when you ask for one of  these  latter 
  93.         fonts  so  you  can expect garbage if you don't  have  the  right 
  94.         equipment. 
  95.  
  96.         In  addition,  BIGTEXT can use EGA or VGA screen fonts (/FS)   to 
  97.         produce  characters.   Screen fonts are typically 4k or  so  TSRs 
  98.         which  install a non-standard font when run.   When the  "screen" 
  99.         font  is selected,  BIGTEXT downloads the definition of the  font 
  100.         which  is currently being displayed on the screen from the  video 
  101.         card and uses it to produce big characters. 
  102.         
  103.         When  the "alternate"  font is selected (/FA),  BIGTEXT uses  the 
  104.         font  definition from the Alternate Character Set Override Table.  
  105.         For a screen font to work with this font mode of BIGTEXT, it must 
  106.         have  definitions  for all 256  characters,  load the  font  into 
  107.         system  RAM  and  place a pointer to the font  in  the  Alternate 
  108.         Character  Set Override Table which is found from the Video  Save 
  109.         Table.   One advantage of this font selection method is that  the 
  110.         font  does  not  have  to be visible to be used  for  making  big 
  111.         characters, just properly installed.  For example, you might want 
  112.         to  use  an old English font to produce a banner but not want  to 
  113.         use  it  for your normal display font.   Even though this is  the 
  114.         method  established by the original IBM VGA BIOS  for  installing 
  115.         screen fonts,  many screen fonts don't use it.   In this case you 
  116.         can always use the "screen" font option.  
  117.         
  118.         With  these last two font selections you can make big  characters 
  119.         in  various novelty fonts and even non-Latin character sets  like 
  120.         Cyrillic, Greek or Arabic.  For use with BIGTEXT, I have uploaded 
  121.         the  file  NVLTFNTS.ZIP  to the screen directory  of  the  SIMTEL 
  122.         archive  (if  you have FTP access to the internet,  this  can  be 
  123.         found at the mirror site, oak.oakland.edu. in /pub/msdos/screen).  
  124.         This  file  contains a collection of 12  screen fonts  which  are 
  125.         suitable for use with BIGTEXT in either "screen"  or  "alternate" 
  126.         font modes.   Some of the fonts included are old english, script, 
  127.         small capitals, OCR and computer.   If you are really into screen 
  128.         fonts, check out the file fntcol16.zip in the same directory.  It 
  129.         has  over 200  (!)   screen fonts which are compatible  with  the 
  130.         loader in NVLTFNTS.   There are other font packages in the screen 
  131.         and vga directories of the SIMTEL archive.  There are even screen 
  132.         font  editors  (I'd recommend EVAFONT)  if you  are  inclined  to 
  133.         design your own! 
  134.  
  135.        ┌─────────────────────────────────────────────────────────────────┐
  136.        │▒▒▒ Bricks ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  137.        └─────────────────────────────────────────────────────────────────┘
  138.  
  139.         By default,  BIGTEXT uses IBM block characters as the bricks used 
  140.         to build the big characters.  Obviously, this is not desirable if 
  141.         you  want to e-mail your big text or print it on a printer  which 
  142.         can  only print ASCII characters so BIGTEXT provides two ways  to 
  143.         specify which characters to use to build big and vertical styles. 
  144.         You  can specify the character used either by giving examples  of 
  145.         the  characters to use for the foreground and background (/C)  or 
  146.         numerically  (/N)   which is useful for specifying the PC's  non-
  147.         ASCII  characters.   To use the /C switch just follow it with the 
  148.         character  to use for the foreground and  optionally  background. 
  149.         For straight ASCII text *,  # and [ are popular.   When using the 
  150.         graphics character set many nice effects can be produced by using 
  151.         the  shaded block or line drawing characters.  One nice effect is 
  152.         to have blank letters against a patterned background.   Since you 
  153.         can't  specify  a blank foreground directly (because  that  would 
  154.         terminate  the  switch specification)  use  the  character  whose 
  155.         numeric value is 255; it always displays as blank. 
  156.  
  157.         However, note that MS-DOS and the console driver will filter some 
  158.         characters out,  e.g.  < and ESC.   Characters which are filtered 
  159.         out  by the command line interpreter such as "<"  can be produced 
  160.         for output with the /N switch.   For example,  /N60  will produce 
  161.         output composed of "<"  characters. ESC, which displays as a left 
  162.         arrow,   is filtered on the output side as well as the input side 
  163.         so you can't use that symbol to build text bound for a file  (but 
  164.         if  you  use  the  attribute command you can display  it  on  the 
  165.         screen). 
  166.  
  167.        ┌─────────────────────────────────────────────────────────────────┐
  168.        │▒▒▒ Really Big Characters ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  169.        └─────────────────────────────────────────────────────────────────┘
  170.  
  171.         If  the  big character style is not big enough for you,   BIGTEXT 
  172.         allows  you  to 'magnify'  the output by up to a factor of  9  by 
  173.         using the /Mvh switch.   "v" specifies the vertical magnification 
  174.         and "h" the horizontal.  If you use the 8x16 VGA font, the result 
  175.         can be letters which are each up to 72  by 144 characters.  Using 
  176.         vertical style and a printer which has 14"  wide paper,  you  can 
  177.         make  very conspicuous banners.   Also,  since it is possible  to 
  178.         specify the horizontal and vertical magnification separately, you 
  179.         can adjust the aspect ratio of the output.  Magnification is only 
  180.         available with the 'big' and 'vertical' styles. 
  181.  
  182.        ┌─────────────────────────────────────────────────────────────────┐
  183.        │▒▒▒ Colors ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  184.        └─────────────────────────────────────────────────────────────────┘
  185.  
  186.         If  the output is being sent to the screen,  you can specify  the 
  187.         screen attributes BIGTEXT uses to display your text with the  /Ab 
  188.         switch  where  "b"  is the screen attribute setting expressed  in 
  189.         binary.  For a color video adapter (i.e.  CGA,  EGA or VGA)   the 
  190.         attribute bits have the following meanings: 
  191.  
  192.               Attribute Bits:  7 6 5 4 3 2 1 0
  193.               Foreground Blink ┘ │ │ │ │ │ │ └ Foreground Blue
  194.                 Background Red ──┘ │ │ │ │ └── Foreground Green
  195.               Background Green ────┘ │ │ └──── Foreground Red
  196.                Background Blue ──────┘ └────── Foreground Intensity
  197.  
  198.         Setting  a bit to one enables that color or attribute.   You  can 
  199.         build colors by setting more than one color bit.  For example, to 
  200.         display blinking yellow  text on a blue background, you would use 
  201.         /A10011110.   This switch is available for all styles but  forces 
  202.         the output to the screen (i.e. no redirection to a file). 
  203.  
  204.        ┌─────────────────────────────────────────────────────────────────┐
  205.        │▒▒▒ Other Features ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  206.        └─────────────────────────────────────────────────────────────────┘
  207.  
  208.         ■ BIGTEXT places a newline character at the end of each line (and 
  209.           still manages to put  10   big or short characters on a 'line') 
  210.           where bigecho used the BIOS'  screen wrap feature.   This means 
  211.           that when you capture the output to a file you don't have to do 
  212.           a lot of tedious editing to get usable text. 
  213.         
  214.         ■ BIGTEXT can echo a string starting with '/'  (which is normally 
  215.           the  switch character),   just double it and only one  will  be 
  216.           echoed.  
  217.  
  218.         ■ To include  leading,  trailing or embedded spaces in your  text 
  219.           (for  example,  to center your text),  enclose your text in "s.  
  220.  
  221.        ┌─────────────────────────────────────────────────────────────────┐
  222.        │▒▒▒ Bugs ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  223.        └─────────────────────────────────────────────────────────────────┘
  224.  
  225.         At  this time,  I  know of no bugs in BIGTEXT but there are  some 
  226.         things  which  can  go wrong.   I  have only tested it on  a  few 
  227.         different kinds of VGA cards and since the ability to read screen 
  228.         fonts  depends  on  a deep level of compatibility  with  the  VGA 
  229.         standard;   it wouldn't surprise me if it didn't work  with  some 
  230.         cards.    As  mentioned before,  BIGTEXT does not check  for  the 
  231.         presence   of  appropriate  hardware  before  using  EGA  or  VGA 
  232.         features;   this can cause lots of garbage to be  echoed.    Some 
  233.         screen  fonts install special INT 10  handlers which ensure  that 
  234.         the font remains loaded in all eventualities.  This can cause the 
  235.         E/VGA  BIOS  fonts to become unavailable.   And finally,  if  the 
  236.         lines produced are too wide to fit on your screen,  the BIOS will 
  237.         wrap them causing the big character patterns to be jumbled. 
  238.  
  239.        ┌─────────────────────────────────────────────────────────────────┐
  240.        │▒▒▒ Technical Information ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  241.        └─────────────────────────────────────────────────────────────────┘
  242.  
  243.         How  does  it  work?   In the old days when  the  Color  Graphics 
  244.         Adapter  was designed,  it seemed like a good cost-saving idea to 
  245.         use  the  BIOS ROM to store the character matrices used  for  the 
  246.         graphics  character  set  rather than going  to  the  expense  of 
  247.         increasing  the size of the ROM chip on the CGA board.   To  this 
  248.         day, every BIOS, even for the latest Pentium,  has stored in it a 
  249.         CGA character array!   BIGTEXT simply uses this array to generate 
  250.         big  characters,   substituting a character for every dot in  the 
  251.         array.   Hence, any CGA graphics character,  from the smiley face 
  252.         to the delete character 'house', can be produced by BIGTEXT.  EGA 
  253.         and  VGA cards also store their character matrices in their  BIOS 
  254.         ROMs where they can be read and used by BIGTEXT. 
  255.         
  256.         Narrow and short characters are formed similarly but by using the 
  257.         thick border characters to produce two dots,  either horizontally 
  258.         or  vertically,   with a single character.   Petite style uses  a 
  259.         single  character  to display two pixels  both  horizontally  and 
  260.         vertically.   But since the ordinary IBM border characters  don't 
  261.         provide enough patterns,  some of the line drawing characters are 
  262.         redefined  to provide the missing patterns.   That's why you must 
  263.         have an EGA or VGA card to use the petite style and why you can't 
  264.         print or save the results.  
  265.         
  266.         By  using  existing character definitions,  BIGTEXT  can  produce 
  267.         several neat effects with a very small program. 
  268.  
  269.        ┌─────────────────────────────────────────────────────────────────┐
  270.        │▒▒▒ Registration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  271.        └─────────────────────────────────────────────────────────────────┘
  272.  
  273.         Another  thing  that is similar to bigecho is that,   while  this 
  274.         software may be freely copied and used,  it is being  distributed 
  275.         as POSTWARE.   I  am curious about where in the world this little 
  276.         utility will travel so,  if you use it, please send me a postcard 
  277.         (preferably  a  local  picture postcard).   If that is  too  much 
  278.         trouble, send me some e-mail.   If even that is too much trouble, 
  279.         do  yourself a favor and take some time off to go for a walk in a 
  280.         forest or park! 
  281.  
  282.         Postware  really  works!   Check out the list of features  I  was 
  283.         motivated to think up and add in version 2.0 thanks to all of the 
  284.         cards and messages I received for version 1.0.  Thanks,  and keep 
  285.         'em coming! 
  286.  
  287.         William Luitje 
  288.         2677 Wayside Drive 
  289.         Ann Arbor, MI 48103 USA 
  290.  
  291.         Internet:  luitje@m-net.arbornet.org 
  292.  
  293.        ┌─────────────────────────────────────────────────────────────────┐
  294.        │▒▒▒ Distribution ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  295.        └─────────────────────────────────────────────────────────────────┘
  296.  
  297.         The   BIGTEXT  program  and  its  associated  documentation   and 
  298.         demonstrations  are  copyrighted works of William  Luitje.    The 
  299.         author  grants you a non-exclusive license to copy and distribute 
  300.         these  works as long as they are distributed as a group  and  are 
  301.         not modified in any way. 
  302.  
  303.         On a related note,  I am distributing this program for free.   If 
  304.         you  paid money for a floppy or CD-ROM with this program on it be 
  305.         aware  that I am not seeing a penny of it.   What you paid for is 
  306.         the  service of distribution.   I'm sure that you understand  the 
  307.         nature of transactions like that but I have heard from people who 
  308.         "bought  one  of  my  programs"   and  expect  me  to  conduct  a 
  309.         correspondence  course on basic PC techniques and theory  because 
  310.         of their "purchase".   While I am always open to bug reports  and 
  311.         well  thought  out questions (and postcards!),  please  read  the 
  312.         documentation  carefully and check with local experts before  you 
  313.         fire up your word processor. 
  314.  
  315.        ┌─────────────────────────────────────────────────────────────────┐
  316.        │▒▒▒ History ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  317.        └─────────────────────────────────────────────────────────────────┘
  318.  
  319.         Version 1.0  Nov 1993
  320.            Released as wvlecho with 3 styles and 1 font 
  321.         Version 2.0  Feb 1994 
  322.            Renamed to bigtext
  323.            Added petite and vertical styles
  324.            Added support for E/VGA, screen and alternate fonts 
  325.            Added magnification feature for really big text
  326.         Version 2.1  Feb 1995
  327.            Added /A for colors & blinking effects on screen
  328.  
  329.         Copyright 1995 by William Luitje
  330.